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Summary of the Catalog Manager 


C Summary 

Constants and Data Types 


enum ( 

kThisRecordOwnerBit = 0, 
kFriendsBit = 1, 
kAuthenticatedlnDNodeBit = 2, 
kAuthenticatedlnDirectoryBit = 3, 
kGuestBit = 4, 
kMeBit = 5 


enum { /* Values of CategoryMask */ 

kThisRecordOwnerMask = (1L << kThisRecordOwnerBit), 

kFriendsMask = (1L << kFriendsBit), 

kAuthenticatedlnDNodeMask = (1L << kAuthenticatedlnDNodeBit), 

kAuthenticatedlnDirectoryMask = (1L << kAuthenticatedlnDirectoryBit), 
kGuestMask = (1L << kGuestBit), 

kMeMask = (1L << kMeBit) 

typedef unsigned long CategoryMask; 

} ; enum { 

kEnumDistinguishedNameBit , 
kEnumAliasBit , 
kEnumPseudonymBit , 
kEnumDNodeBit , 
kEnumlnvisibleBit 

} ; 

enum { 

/* values of DirEnumChoices */ 

kEnumDistinguishedNameMask = lL<<kEnumDistinguishedNameBit , 
kEnumAliasMask = lL<<kEnumAliasBit , 

kEnumPseudonymMask = !L<<kEnumPseudonymBit , 
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kEnumDNodeMask = lL<<kEnumDNodeBit , 

kEnumlnvisibleMask = !L<<kEnumInvisibleBit 


#define kEnumAHMask (kEnumDistinguishedNameMask | kEnumAliasMask 

kEnumPseudonymMask | kEnumDNodeMask 
EnumlnvisibleMask) 

typedef unsigned long DirEnumChoices ; 

/* values of DirSortOption */ 
enum { 

kSortByName= 0, 
kSortByType= 1 


00 


typedef unsigned short DirSortOption; 

/* values of DirSortDirection */ 
enum { 

kSortForwards= 0, 
kSortBackwards= 1 

}; 

typedef unsigned short DirSortDirection; 

/* values of DirMatchWith */ 
enum { 

kMatchAll , 

kExactMatch, 

kBeginsWith, 

kEndingWith, 

kContaining 


typedef unsigned char DirMatchWith; 
#define kCurrentOCESortVersionl 1 
enum { 

kSupportsDNodeNumberBit 

kSupportsRecordCreationIDBit 

kSupportsAttributeCreationIDBit 

kSupportsMatchAUBit 

kSupportsBeginsWithBit 
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kSupportsExactMatchBit 
kSupportsEndsWithBit 
kSupportsContainsBit 
kSupportsOrderedEnumerationBit 
kCanSupportNameOrderBit 
kCanSupportTypeOrderBit 
kSupportsSortBackwardsBit 
k Support I ndexRatioBit 
kSupportsEnumerationContinueBit 
kSupportsLookupContinueBit 

kSupportsEnumerateAttributeTypeContinueBit 
kSupportsEnumeratePseudonymContinueBit 
kSupportsAliasesBit 
kSupportsPseudonymsBit 
kSupportsPartialPathnamesBit 
kSupportsAuthenticationBit 
kSupportsProxiesBit 
kSupportsFindRecordBit 

} ; 

/* values of DirGestalt' */ 

enum { 

kSupportsDNodeNumberMask 
kSupportsRecordCreationIDMask 
kSupportsAttributeCreationIDMask 
kSupportsMatchAHMask 
kSupportsBeginsWithMask 
kSupportsExactMatchMask 
kSupportsEndsWithMask 
kSupportsContainsMask 
kSupportsOrderedEnumerationMask 
kCanSupportNameOrderMask 
kCanSupportTypeOrderMask 
kSupportSortBackwardsMask 
kSupport IndexRatioMask 
kSupportsEnumerationContinueMask 
kSupport sLookupContinueMask 
kSupportsEnumerateAttributeTypeContinueMask = 

lL<<kSupportsEnumerateAttributeTypeContinueBit , 
kSupportsEnumeratePseudonymContinueMask = 

lL<<kSupportsEnumeratePseudonymContinueBit , 
kSupportsAliasesMask = lL<<kSupportsAliasesBit , 

kSupportsPseudonymsMask = lL<<kSupportsPseudonymsBit , 

kSupportsPartialPathNamesMask = !L<<kSupportsPartialPathNamesBit , 


= lL<<kSupportsDNodeNumberBit , 

= lL<<kSupportsRecordCreationIDBit , 

= lL<<kSupportsAttributeCreationIDBit , 
= lL<<kSupportsMatchAHBit , 

= lL<<kSupportsBeginsWithBit , 

= lL<<kSupportsExactMatchBit , 

= lL<<kSupportsEndsWithBit , 

= lL<<kSupportsContainsBit , 

= lL<<kSupportsOrderedEnumerationBit , 

= lL<<kCanSupportNameOrderBit , 

= lL<<kCanSupportTypeOrderBit , 

= lL<<kSupportSortBackwardsBit , 

= lL<<kSupportIndexRatioBit, 

= lL<<kSupportsEnumerationContinueBit , 
= !L<<kSupportsLookupContinueBit , 
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kSupportsAuthenticationMask = lL<<kSupportsAuthenticationBit , 

kSupportsProxiesMask = lL<<kSupportsProxiesBit , 

kSupportsFindRecordMask = lL<<kSupportsFindRecordBit 

}; 

typedef unsigned long DirGestalt; 


struct DNodelD 

{ 



DNodeNum 

dNodeNumber ; 

/* 

dNode number */ 

long 

reservedl ; 

/* 

reserved */ 

RStringPtr 

name ; 

/* 

name of the dNode */ 

long 

reserved2 ; 

/* 

reserved */ 


}; 

typedef struct DNodelD DNodelD; 


struct DirEnumSpec { 

DirEnumChoices 
unsigned short 

union { 

LocalRecordID 
DNodelD 
}u; 

}; 

typedef struct DirEnumSpec DirEnumSpec; 

struct DirMetalnfo { 

unsigned longinfo[4]; 

}; 

typedef struct DirMetalnfo DirMetalnfo; 

struct SLRV { 

ScriptCode 
short 
short 
short 

}; 

typedef struct SLRV SLRV; 


script; /* script code in which entries are sorted */ 

language; /* language code in which entries are sorted */ 
regionCode; /* region code in which entries are sorted */ 
version; /* version of AOCE sorting software */ 


enumFlag; 

indexRatio; /* if supported, record position between 1 
and 100. 0 if not supported */ 

recordldentif ier ; 
dNode Identifier; 


typedef unsigned long Authldentity ; 


00 
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typedef pascal Boolean ( *ForEachRecordID) (long clientData, 

const RecordID* recordID) ; 

typedef pascal Boolean ( *ForEachAttrType) (long clientData, 

const AttributeType *attrType) ; 

{ FUNCTION ForEachLookupRecordID (clientData : long; recordID: RecordID) : BOOL- 
EAN; } 

{ FUNCTION ForEachAttrTypeLookup (clientData : long; attrType: 

AttributeTypePtr; myAttrAccMask : AccessMask) : BOOLEAN;} 

{ FUNCTION ForEachAttrValue (clientData : long; attribute: Attribute): 

BOOLEAN; } 

typedef pascal Boolean ( *ForEachDNodeAccessControl ) (long clientData, 

const DSSpec *dsObj, AccessMask activeDnodeAccMask, 
AccessMask defaultRecordAccMask, 

AccessMask defaultAttributeAccMask) ; 

#define AuthDirParamHeader 


Ptr 

qLink; 

/* 

reserved */\ 

long 

reserved_Hl ; 

/* 

reserved */\ 

long 

reserved_H2 ; 

/* 

reserved */\ 

ProcPtr 

ioCompletion; 

/* 

your completion routine */\ 

OSErr 

ioResult ; 

/* 

result code */\ 

unsigned long 

saveA5 ; 

/* 

reserved */\ 

short 

reqCode; 

/* 

CSAM request code*/\ 

long 

reserved [2 ] ; 

/* 

reserved */\ 

AddrBlock 

serverHint ; 

/* 

PowerShare server' s AppleTalk address 

short 

dsRefNum; 

/* 

personal catalog reference number */\ 

unsigned long 

calllD; 

/* 

reserved */\ 

Authldentity 

identity; 

/* 

requester's authentication identity */ 

long 

gReservedl ; 

/* 

reserved */\ 

long 

gReserved2 ; 

/* 

reserved */\ 

long 

gReserved3 ; 

/* 

reserved */\ 

long 

clientData; 

/* 

you define this field */ 


struct DirEnumerateDirectoriesGetPB { 


AuthDirParamHeader 



OCEDirectoryKind 

directoryKind; 

/* 

enumerate catalogs 
bearing this signature */ 

Direct oryNamePtr 

startingDirectoryName ; 

/* 

starting catalog */ 

DirDiscriminator 

startingDirDiscriminator ; 

/* 

starting catalog 
discriminator */ 
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long 

long 

long 

long 

Boolean 


eReserved; 

fReserved; 

gReserved; 

hReserved; 

include St art ingPoint ; 


Byte 

short 

Ptr 

unsigned long 


padByte; 
HReserved; 
getBuf fer ; 
getBuf ferSize; 


/* if true, return the 
catalog specified by 
starting point */ 


00 


typedef struct DirEnumerateDirectoriesGetPB DirEnumerateDirectoriesGetPB; 


struct DirEnumerateDirectoriesParsePB { 
AuthDirParamHeader 


long 

long 

long 

long 

ForEachDi rectory 

long 

long 

long 

long 

Ptr 

unsigned long 


aReserved; 

hReserved; 

eReserved; 

dReserved; 

eachDirectory; 

fReserved; 

gReserved; 

hReserved; 

iReserved; 

getBuf fer ; 

getBuf ferSize; 


}; 


typedef struct DirEnumerateDirectoriesParsePB DirEnumerateDirectoriesParsePB; 


struct DirFmdRecordGetPB { 
AuthDirParamHeader 


RecordIDPtr 

long 

RStringPtr 

RStringPtr* 

unsigned long 

long 

short 

DirMatchWith 

DirMatchWith 

Ptr 


st art ingPoint ; 
reservedA [2 ] ; 
nameMatchStrin 
typesList ; 
typeCount ; 
reservedB; 
reservedC; 
matchNameHow; 
matchTypeHow; 
getBuf fer; 


g; 
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unsigned long 
Direct oryNamePtr 
DirDiscriminator 


getBufferSize; 
di recto ryName; 
discriminator; 


typedef struct DirFindRecordGetPB DirFindRecordGetPB; 
struct DirFindRecordParsePB { 


AuthDirParamHeader 

RecordIDPtr 

startingPoint ; 

long 

reservedA [2 ] ; 

RStringPtr 

nameMatchString; 

RStringPtr* 

typesList ; 

unsigned long 

typeCount ; 

long 

reservedB; 

short 

reservedC; 

DirMatchWith 

matchNameHow; 

DirMatchWith 

matchTypeHow; 

Ptr 

getBuffer; 

unsigned long 

getBufferSize; 

DirectoryNamePtr 

directoryName; 

DirDiscriminator 

discriminator; 

ForEachRecord 

f orEachRecordFunc ; 


typedef struct DirFindRecordParsePB DirFindRecordParsePB; 

struct DirGetDirectorylnf oPB { 

AuthDirParamHeader 

DirectoryNamePtr directoryName; /* catalog name */ 

DirDiscriminator discriminator; /* descriminate between duplicate 

catalog names */ 

DirGestalt features; /* capability bit flags */ 

} ; 


typedef struct DirGetDirectorylnf oPB DirGetDirectorylnf oPB; 
struct DirGetLocalNetworkSpecPB { 


AuthDirParamHeader 



DirectoryNamePtr 

directoryName; 

/* 

catalog name */ 

DirDiscriminator 

discriminator; 

/* 

discriminator */ 

NetworkSpecPtr 

networkSpec; 

/* 

NetworkSpec */ 
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typedef struct DirGetLocalNetworkSpecPB DirGetLocalNetworkSpecPB; 


struct DirGetDirectorylconPB { 
AuthDirParamHeader 
PackedRLIPtr pRLI; 

OSType iconType; 

Ptr iconBuffer; 

unsigned long bufferSize; 


/* packed RLI for the catalog */ 

/* type of icon requested */ 

/* buffer to hold icon data */ 

/* size of buffer to hold icon data */ 


typedef struct DirGetDirectorylconPB 

struct Di rGetExtendedDi rectories Inf oPB 
AuthDirParamHeader 
Ptr 

unsigned long 

unsigned long 
unsigned long 

}; 

typedef struct 


DirGetDirectorylconPB; 


/* Pointer to a buffer where data 
will be returned */ 
length of actual data will be 
returned here */ 

/* total number of catalogs found */ 
/* total number of catalog entries */ 
returned */ 


Di rGetExtendedDi rectories Inf oPB 

Di rGetExtendedDi rectories Inf oPB; 


buffer; 

bufferSize; 

totalEntries ; 
actualEntries ; 


typedef pascal Boolean ( *ForEachDirectory ) ( 

long clientData, const DirectoryName *dirName, 

const DirDiscriminator *discriminator , DirGestalt features); 


struct DirEnumerateGetPB { 

AuthDirParamHeader 

PackedRLIPtr aRLI; /* an RLI specifying the cluster 

to be enumerated */ 


DirEnumSpec 

*startingPoint ; 


DirSortOption 

sortBy; 


DirSortDirection 

sortDirection; 


long 

dRe serve d ; 


RStringPtr 

nameMatchString; 

/* 

RStringPtr 

*typesList ; 

/* 

unsigned long 

typeCount ; 

/* 

DirEnumChoices 

enumFlags ; 

/* 

Boolean 

include St art ingPoint ; 


name from which enumeration should 
start */ 

list of entity types to be 
enumerated */ 

number of types in the list */ 
indicates what to enumerate */ 


00 
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/* 

if true, return the record 
specified in starting point */ 

Byte 

padByte; 



DirMatchWith 

matchNameHow; 

/* 

matching criteria for 
nameMatchString */ 

DirMatchWith 

matchTypeHow; 

/* 

matching riteria for typeList */ 

Ptr 

getBuf fer; 



unsigned long 

getBufferSize; 



SLRV 

response SLRV; 

/* 

response SLRV */ 


typedef struct DirEnumerateGetPB DirEnumerateGetPB; 


struct DirEnumerateParsePB { 


AuthDirParamHeader 

PackedRLIPtr 

aRLI; 

long 

bReserved; 

long 

cReserved; 

ForEachDirEnumSpec 

eachEnumSpec ; 

long 

eReserved; 

long 

fReserved; 

long 

gRe serve d; 

long 

hRe serve d; 

long 

iReserved; 

Ptr 

getBuf fer ; 

unsigned long 

getBufferSize; 

short 

HReserved; 

short 

12Reserved; 

short 

13Reserved; 

short 

14Reserved; 


/* an RLI specifying the cluster to 
be enumerated */ 


typedef struct DirEnumerateParsePB DirEnumerateParsePB; 

struct DirGetDNodeMetalnf oPB { 

AuthDirParamHeader 
PackedRLIPtr pRLI; 

DirMetalnfo metainfo; 

}; 


typedef struct DirGetDNodeMetalnf oPB DirGetDNodeMetalnf oPB; 
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struct DirMapDNodeNumberToPathNamePB { 


AuthDirParamHeade 
Direct oryNamePtr 
DirDiscriminator 
DNodeNum 

PackedPathNamePtr 
unsigned short 


di recto ryName ; 
discriminator; 
dNodeNumber; 
path; 

lengthOf PathName ; 


/* catalog name */ 

/* discriminator */ 

/* dNode number to be mapped */ 
/* packed pathname returned */ 

/* length of packed pathname 
structure* / 


typedef struct DirMapDNodeNumberToPathNamePB DirMapDNodeNumberToPathNamePB; 

struct DirMapPathNameToDNodeNumberPB { 

AuthDirParamHeader 

DirectoryNamePtr directoryName; 

DirDiscriminator discriminator; 

DNodeNum dNodeNumber; 

PackedPathNamePtr path; 

}; 

typedef struct DirMapPathNameToDNodeNumberPB DirMapPathNameToDNodeNumberPB; 

struct DirGetDNodelnf oPB { 

AuthDirParamHeader 
PackedRLIPtr pRLI; 

DirNodeKind descriptor; 

NetworkSpecPtr networkSpec; 

}; 

typedef struct DirGetDNodelnf oPB DirGetDNodelnf oPB; 

struct DirAddADAPDirectoryPB { 

AuthDirParamHeader 

DirectoryNamePtr directoryName; /* catalog name */ 

DirDiscriminator discriminator; /* discriminate between duplicate 

catalog names */ 

Boolean addToOCESetup; /* add this catalog to PowerTalk 

Setup */ 

Byte padByte; 

CreationID directoryRecordCID; 

/* creation ID for the catalog 
record */ 

}; 


/* packed RLI whose info is requested */ 
/* dNode descriptor */ 

/* cluster's networkSpec if klsCluster */ 


/* catalog name */ 

/* discriminator */ 

/* dNode number to the path */ 
/* pathname to be mapped */ 
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typedef struct DirAddADAPDirectoryPB DirAddADAPDirectoryPB; 


struct DirFindADAPDirectoryByNetSearchPB { 
AuthDirParamHeader 
DirectoryNamePtr directoryName; 
DirDiscriminator discriminator; 


Boolean 

Byte 

CreationID 


addToOCESetup; 


/* catalog name */ 

/* discriminate between duplicate 
catalog names */ 

/* add this catalog to PowerTalk 
setup list */ 

padByte ; 

directoryRecordCID; 

/* creation ID for the catalog 
record */ 


typedef struct DirFindADAPDirectoryByNetSearchPB 

D irFindADAPDi recto ryByNet Sear chPB; 


struct DirNetSearchADAPDirectoriesGetPB { 
AuthDirParamHeader 
Ptr getBuffer; 

unsigned long getBuf ferSize; 
long cReserved; 

}; 


typedef struct DirNetSearchADAPDirectoriesGetPB 

DirNetSearchADAPDirectoriesGetPB; 

struct DirNetSearchADAPDirectoriesParsePB { 

AuthDirParamHeader 

Ptr getBuffer; 

unsigned long getBufferSize; 

ForEachADAPDi rectory eachADAPD i rectory; 


typedef struct DirNetSearchADAPDirectoriesParsePB 

D irNet Sear chADAPDi rector iesParsePB; 

typedef pascal Boolean ( *ForEachADAPDirectory ) ( 

long clientData, const DirectoryName *dirName, 
const DirDiscriminator *discriminator , DirGestalt features, 

AddrBlock serverHint) ; 
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struct DirRemoveDirectoryPB { 

AuthDirParamHeader 

CreationID directoryRecordCID; /* creation ID for the catalog record */ 

}; 

typedef struct DirRemoveDirectoryPB DirRemoveDirectoryPB; 

struct DirGetOCESetupRefNumPB { 

AuthDirParamHeader 

CreationID oceSetupRecordCID; /* creation ID for the catalog record */ 

}; 

typedef struct DirGetOCESetupRefNumPB DirGetOCESetupRefNumPB; 

struct DirCreatePersonalDirectoryPB { 

AuthDirParamHeader 

FSSpecPtr fsSpec; /* FSSpec for the personal catalog */ 

OSType fdType; /* file type for the personal catalog */ 

OSType fdCreator; /* file creator for the personal catalog */ 

}; 

typedef struct DirCreatePersonalDirectoryPB DirCreatePersonalDirectoryPB; 

struct DirOpenPersonalDirectoryPB { 

AuthDirParamHeader 

FSSpecPtr fsSpec; /* open an existing personal catalog */ 

char accessRequested; /* open: permissions requested (byte) */ 

char accessGranted; /* open: permissions (byte) (granted) */ 

DirGestalt features; /* features for personal catalog */ 

}; 

typedef struct DirOpenPersonalDirectoryPB DirOpenPersonalDirectoryPB; 

struct DirClosePersonalDirectoryPB { 

AuthDirParamHeader 

}; 

typedef struct DirClosePersonalDirectoryPB DirClosePersonalDirectoryPB; 

struct DirMakePersonalDirectoryRLIPB { 

AuthDirParamHeader 

FSSpecPtr fromFSSpec; /* FSSpec for creating relative alias */ 

unsigned short pRLIBuf ferSize; /* length of ' pRLI' buffer */ 

unsigned short pRLISize; /* length of actual ' pRLI' */ 

PackedRLIPtr pRLI; /* pRLI for the specified address book */ 

}; 
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typedef struct DirMakePersonalDirectoryRLIPB DirMakePersonalDirectoryRLIPB; 

struct DirAddRecordPB { 

AuthDirParamHeader 

RecordIDPtr aRecord; /* Creation ID returned here */ 

Boolean allowDuplicate; 

} ; 


typedef struct DirAddRecordPB DirAddRecordPB; 

struct DirDeleteRecordPB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

}; 


typedef struct DirDeleteRecordPB DirDeleteRecordPB; 

struct DirGetRecordMetalnf oPB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

DirMetalnfo metainfo; 

} ; 


typedef struct DirGetRecordMetalnf oPB DirGetRecordMetalnfoPB; 

struct DirGetNameAndTypePB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

} ; 


typedef struct DirGetNameAndTypePB DirGetNameAndTypePB; 


struct DirSetNameAndTypePB { 
AuthDirParamHeader 
RecordIDPtr aRecord; 

Boolean allowDuplicate; 

Byte padByte; 

RStringPtr newName; 
RStringPtr newType; 


/* new name for the record */ 
/* new type for the record */ 


typedef struct DirSetNameAndTypePB DirSetNameAndTypePB; 

struct DirAddPseudonymPB { 

AuthDirParamHeader 

RecordIDPtr aRecord; /* Record ID to be added to pseudonym */ 
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RStringPtr pseudonymName; /* new name to be added as pseudonym */ 

RStringPtr pseudonymType; /* new name to be added as pseudonym */ 

Boolean allowDuplicate; 

}; 

typedef struct DirAddPseudonymPB DirAddPseudonymPB; 

struct DirDeletePseudonymPB { 

AuthDirParamHeader 

RecordIDPtr aRecord; /* Record ID to which pseudonym is 

to be added */ 

RStringPtr pseudonymName; /* pseudonym name to be deleted */ 

RStringPtr pseudonymType; /* pseudonym type to be deleted */ 

}; 

typedef struct DirDeletePseudonymPB DirDeletePseudonymPB; 

struct DirEnumeratePseudonymGetPB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

RStringPtr startingName; 

RStringPtr startingType; 

long dReserved; 

long eReserved; 

long fReserved; 

long gReserved; 

long hReserved; 

Boolean includeStartingPoint ; 

Byte padByte; 

short HReserved; 

Ptr getBuffer; 

unsigned long getBuf ferSize; 

}; 

typedef struct DirEnumeratePseudonymGetPB DirEnumeratePseudonymGetPB; 

struct DirEnumeratePseudonymParsePB { 

AuthDirParamHeader 

RecordIDPtr aRecord; /* same as DirEnumerateAliasesGetPB */ 

long bReserved; 

long eReserved; 

ForEachRecordID eachRecordID; 
long eReserved; 


/* if true, the pseudonym 

specified by starting point will 
be included */ 
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long 

long 

long 

long 

Ptr 

unsigned long 

}; 


fReserved; 
gRe serve d; 
hRe serve d; 
iReserved; 
getBuf fer ; 
getBuf fer Size; 


typedef struct DirEnumeratePseudonymParsePB DirEnumeratePseudonymParsePB; 

struct DirAddAliasPB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

Boolean allowDuplicate; 

}; 


typedef struct DirAddAliasPB DirAddAliasPB; 

struct DirAddAttributeValuePB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

AttributePtr attr; /* AttributeCreationID returned here */ 


typedef struct DirAddAttributeValuePB DirAddAttributeValuePB; 

struct DirDeleteAttributeValuePB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

AttributePtr attr; 


typedef struct DirDeleteAttributeValuePB DirDeleteAttributeValuePB; 

struct DirChangeAttributeValuePB { 

AuthDirParamHeader 
RecordIDPtr aRecord; 

AttributePtr currentAttr; 

AttributePtr newAttr; 

}; 

#ifndef cplusplus 

typedef struct DirChangeAttributeValuePB DirChangeAttributeValuePB; 
#endif 
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struct DirVerifyAttributeValuePB { 
AuthDirParamHeader 
RecordIDPtr aRecord; 
AttributePtr attr; 


typedef struct DirVerifyAttributeValuePB DirVerifyAttributeValuePB; 


struct DirFindValuePB { 


AuthDirParamHeader 

PackedRLIPtr aRLI; 

LocalRecordIDPtr 

aRecord; 

AttributeTypePtr 

attrType; 

LocalRecordIDPtr 

startingRecord; 

AttributePtr 

startingAttribute; 

LocalRecordIDPtr 

recordFound; 

Attribute 

attributeFound; 

unsigned long 

Ptr 

matchSize; 

matchingData; 

DirSortDirection 

sort Direct ion; 


/* 

an RLI specifying the cluster to 


be enumerated */ 


/* 

if not nil 

, look only in 

this 


record */ 



/* 

if not nil 

, look only in 

this 


attribute 

type */ 


/* 

record in 

which to start 



searching 

*/ 


/* 

attribute 

in which to start 


searching 

*/ 


/* 

record in 

which data was 



found */ 



/* 

attribute 

in which data ' 

was 


found */ 



/* 

length of 

matching bytes 

*/ 

/* 

data bytes 

to be matched 

in * / 


search */ 



/* 

sort direction (forward 

or * / 


backward) 

*/ 



typedef struct DirFindValuePB DirFindValuePB; 


struct DirLookupGetPB { 


AuthDirParamHeade 

RecordIDPtr 

AttributeTypePtr 

long 

long 

long 

long 

unsigned long 
unsigned long 
Boolean 


*aRecordList ; /* an 

*attrTypeList ; /* an 
cReserved; 
dReserved; 
eReserved; 
fRe served; 
recordIDCount ; 
attrTypeCount ; 
include St art ingPoint 


array of 
array of 


record ID pointers 
attribute types */ 


*/ 


00 
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/* if true, return the value specified 
by the starting indices */ 


Byte 

padByte; 





short 

ilReserved; 





Ptr 

getBuf fer; 





unsigned long 

getBufferSize; 





unsigned long 

startingRecordlndex; 






/* start 

from 

this 

record */ 


unsigned long 

s tart ingAttr Type Index ; 






/* start 

from 

this 

attribute 

type */ 

Attribute 

s tart ingAttr ibute; 






/* start 

from 

this 

attribute 

value */ 

long 

pReserved; 






typedef struct DirLookupGetPB DirLookupGetPB; 


struct DirLookupParsePB { 
AuthDirParamHeader 
RecordIDPtr * 

AttributeTypePtr * 

long 

ForEachLookupRecordID 
ForEachAttrTypeLookup 
ForEachAttrValue 
unsigned long 

unsigned long 

long 

Ptr 

unsigned long 
unsigned long 

unsigned long 

Attribute 


aRecordList ; 

/* must be same from the 
attrTypeList ; 

/* must be same 
cReserved; 
eachRecordID; 
eachAttrType; 
eachAttrValue; 
recordIDCount ; 

/* must be same 
attrTypeCount ; 

/* must be same 
iReserved; 
getBuf fer ; 

/* must be same 
getBuf fer Size; 

/* must be same 
lastRecordlndex; 

/* last record ID 
completed */ 

1 as t At tribute Index ; 

/* last attribute type 
completed */ 

1 as t At tribute ; 

/* last attribute value 


corresponding Get call */ 
corresponding Get call */ 

corresponding Get call */ 
corresponding Get call */ 

corresponding Get call */ 


from the 

from the 

from the 

from the 

from the corresponding Get call */ 
processed when parse 

processed when parse 

(with this CreationID) 
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unsigned long 


processed when parse completed */ 
attrSize; 

/* length of the attribute that was not 
returned */ 


typedef struct DirLookupParsePB DirLookupParsePB; 

struct DirDeleteAttributeTypePB { 
AuthDirParamHeader 
RecordIDPtr aRecord; 

AttributeTypePtr attrType; 

}; 


00 


typedef struct DirDeleteAttributeTypePB DirDeleteAttributeTypePB; 


struct DirEnumerateAttributeTypesGetPB { 
AuthDirParamHeader 
RecordIDPtr aRecord; 

AttributeTypePtr startingAttrType ; 

/* starting point */ 


long 

long 

long 

long 

long 

long 

Boolean 


cReserved; 

dReserved; 

eReserved; 

fReserved; 

gReserved; 

hReserved; 

include St art ingPoint ; 

/* if true, return the attrType 
specified by starting point */ 


Byte 

short 

Ptr 

unsigned long 


padByte; 
HReserved; 
getBuf fer ; 
getBuf ferSize; 


}; 


typedef struct DirEnumerateAttributeTypesGetPB 

DirEnumerateAttributeTypesGetPB; 


struct DirEnumerateAttributeTypesParsePB { 

AuthDirParamHeader 

RecordIDPtr aRecord; /* Same as 

DirEnumerateAttributeTypesGetPB * / 

long bReserved; 

long cReserved; 
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long 

ForEachAttrType 

long 

long 

long 

long 

Ptr 

unsigned long 

} ; 


dReserved; 
eachAttrType; 
fRe served; 
gRe serve d; 
hRe serve d; 
iReserved; 
getBuf fer ; 
getBuf fer Size; 


typedef struct DirEnumerateAttributeTypesParsePB 

D irEnurae rat eAt tribute Type sPars ePB; 


struct DirGetDNodeAccessControlGetPB { 
AuthDirParamHeader 
PackedRLIPtr pRLI; /’ 


long 

long 

long 

long 

Boolean 

DSSpec 

Boolean 


Ptr 

unsigned long 


RLI of the cluster whose access control 

list is sought */ 

unused */ 

unused */ 

unused */ 


bReserved; /’ 
cReserved; /’ 
dReserved; /’ 
eResreved; 
f orCur rent Use rOnly ; 

*startingPoint ; 

/* starting point */ 
include St art ingPoint ; 

/* if true, return the DsObject 
specified in starting point */ 

getBuffer; 

getBufferSize; 


} ; 


typedef struct DirGetDNodeAccessControlGetPB DirGetDNodeAccessControlGetPB; 


struct DirGetDNodeAccessControlParsePB { 
AuthDirParamHeader 


PackedRLIPtr 

pRLI ; 

/* 

RLI of 

the cluster */ 

long 

bReserved; 

/* 

unused 

*/ 

long 

cReserved; 

/* 

unused 

*/ 

long 

dReserved; 

/* 

unused 

*/ 

ForEachDNodeAccessControl 

eachOb ject ; 




Boolean 

f orCur rent Use rOnly; 



DSSpec 

* st art ingPoint ; 

/* 

starting point */ 


Boolean 


include St art ingPoint ; 

/* if true, return the 
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record specified in 
starting point */ 

Ptr getBuffer; 

unsigned long getBuf ferSize; 


} ; 


typedef struct DirGetDNodeAccessControlParsePB 

DirGetDNodeAccessControlParsePB; 


struct DirGetRecordAccessControlGetPB { 
AuthDirParamHeader 


RecordIDPtr 

aRecord; 

/* 

ID of record whose access 




control list is sought */ 

long 

bReserved; 

/* 

unused */ 

long 

cReserved; 

/* 

unused */ 

long 

dReserved; 

/* 

unused */ 

long 

eReserved; 



Boolean 

f orCur rent Use rOnly 

r 


DSSpec 

*startingPoint ; 

/* 

starting point */ 


Boolean includeStartingPoint ; 

/* if true, return the DsObject 
specified in starting point */ 


Ptr 

unsigned long 


getBuffer; 
getBuf ferSize; 


00 


typedef struct DirGetRecordAccessControlGetPB DirGetRecordAccessControlGetPB; 


struct DirGetRecordAccessControlParsePB { 
AuthDirParamHeader 

RecordIDPtr aRecord; 

long bReserved; 

long cReserved; 

long dReserved; 

ForEachRecordAccessControl eachOb ject ; 


/* ID of record to which access 
control list is sought */ 

/* unused */ 

/* unused */ 

/* unused */ 


Boolean 

DSSpec 

Boolean 


f orCur rent Use rOnly ; 

*startingPoint ; 

/* starting point */ 
includeStartingPoint ; 

/* if true return the record 

specified in starting point */ 
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Ptr getBuffer; 

unsigned long getBuf ferSize; 


typedef struct DirGetRecordAccessControlParsePB 

DirGetRecordAccessControlParsePB; 


struct DirGetAttributeAccessControlGetPB { 
AuthDirParamHeader 
RecordIDPtr aRecord; 


AttributeTypePtr aType; 


long 

long 

long 

Boolean 


cReserved; 
dReserved; 
eResrved; 

f orCur rent Use rOnly; 


/* ID of record to which access control 
list is sought */ 

/* attribute type to which access 
controls are sought */ 

/* unused */ 

/* unused */ 


DSSpec 

Boolean 

Ptr 


*startingPoint ; 

/* starting point */ 
includeStartingPoint ; 

/* if true return the DsObject */ 
/* specified in starting point */ 

getBuffer; 


unsigned longgetBuf ferSize; 


} ; 


typedef struct DirGetAttributeAccessControlGetPB 

DirGetAttributeAccessControlGetPB; 

struct DirGetAttributeAccessControlParsePB { 

AuthDirParamHeader 


RecordIDPtr 

aRecord; 

/* 

ID of record to 

control list is 

which access 

sought */ 

AttributeTypePtr 

aType; 

/* 

attribute type 

access controls 

to which 

are sought */ 

long 

cReserved; 

/* 

unused */ 


long 

dReserved; 

/* 

unused */ 



ForEachAttributeAccessControl eachOb ject ; 

Boolean forCurrentUserOnly; 

DSSpec *startingPoint; 

/* starting point */ 

Boolean includeStartingPoint; 

/* if true, return the record 
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Ptr 

unsigned long 


specified in starting point */ 

getBuf fer ; 
getBuf fer Size; 


typedef struct DirGetAttributeAccessControlParsePB 

DirGetAttributeAccessControlParsePB; 


struct DirAbortPB { 
AuthDirParamHeader 
union DirParamBlock 


}; 


*pb;/* parameter block for the call that must 
be aborted */ 


00 


typedef struct DirAbortPB 

typedef union AuthParamBlock 

typedef AuthParamBlock 

union DirParamBlock { 

struct {AuthDirParamHeader} 

D i r AddRe c o r dP B 

DirDeleteRecordPB 

DirEnumerateGetPB 

DirEnumerateParsePB 

DirFindRecordGetPB 

DirFindRecordParsePB 

DirLookupGetPB 

DirLookupParsePB 

DirAddAttributeValuePB 

DirDeleteAttributeTypePB 

DirDeleteAttributeValuePB 

DirChangeAttributeValuePB 

DirVerifyAttributeValuePB 

DirFindValuePB 

DirEnumeratePseudonymGetPB 

DirEnumeratePseudonymParsePB 

DirAddPseudonymPB 

DirDeletePseudonymPB 

DirAddAliasPB 

DirEnumerateAttributeTypesGetPB 

DirEnumerateAttributeTypesParsePB 

DirGetNameAndTypePB 

DirSetNameAndTypePB 

Summary of the Catalog Manager 


DirAbortPB; 

AuthParamBlock; 

*AuthParamBlockPtr ; 

header; 

addRecordPB; 

deleteRecordPB; 

enumerateGetPB; 

enumerateParsePB; 

f indRecordGetPB; 

findRecordParsePB; 

lookupGetPB; 

lookupParsePB; 

addAttributeValuePB; 

deleteAttributeTypePB; 

deleteAttributeValuePB; 

changeAttributeValuePB; 

verifyAttributeValuePB; 

findValuePB; 

enumeratePseudonymGetPB; 

enumeratePseudonymParsePB; 

addPseudonymPB; 

deletePseudonymPB; 

addAliasPB; 

enumerateAttributeTypesGetPB; 
enumerateAttributeTypesParsePB; 
getNameAndTypePB ; 
setNameAndTypePB; 
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DirGetRecordMetalnf oPB 
DirGetDNodeMetalnf oPB 
Di rGetDi rectory Inf oPB 

DirGetDNodeAccessControlGetPB 

DirGetDNodeAccessControlParsePB 

DirGetRecordAccessControlGetPB 

DirGetRecordAccessControlParsePB 

DirGetAttributeAccessControlGetPB 

DirGetAttributeAccessControlParsePB 

DirEnumerateDirectoriesGetPB 

DirEnumerateDirectoriesParsePB 

DirAddADAPDirectoryPB 

DirRemoveDirectoryPB 

DirNetSearchADAPDirectoriesGetPB 

DirNetSearchADAPDirectoriesParsePB 

DirFindADAPDirectoryByNetSearchPB 

DirMapDNodeNumberToPathNamePB 

DirMapPathNameToDNodeNumberPB 

DirGetLocalNetworkSpecPB 

DirGetDNodelnf oPB 

/* calls for personal catalogs */ 
DirCreatePersonalDirectoryPB 
DirOpenPersonalDirectoryPB 
DirClosePersonalDirectoryPB 
DirMakePersonalDirectoryRLIPB 

/* calls for CSAM's */ 

DirAddDSAMPB 

Dir Inst ant iateDSAMPB 

DirRemoveDSAMPB 

DirAddDSAMDirectoryPB 

Di rGetExtendedDi rectories Inf oPB 

Di rGetDi rectory I conPB 


getRecordMetalnf oPB; 

getDNodeMetalnfoPB; 

getDirectorylnfoPB; 

getDNodeAccessControlGetPB; 

getDNodeAccessControlParsePB; 

getRecordAccessControlGetPB; 

getRecordAccessControlParsePB; 

getAttributeAccessControlGetPB; 

getAttributeAccessControlParsePB; 

enumerateDirectoriesGetPB; 

enumerateDirectoriesParsePB; 

addADAPDirectoryPB; 

removeDirectoryPB; 

netSearchADAPDirectoriesGetPB; 

netSearchADAPDirectoriesParsePB; 

f indADAPDirectoryByNetSearchPB; 

mapDNodeNumberToPathNamePB; 

mapPathNameToDNodeNumberPB; 

getLocalNetworkSpecPB; 

getDNodelnfoPB; 

createPersonalDirectoryPB; 

openPersonalDirectoryPB; 

closePersonalDirectoryPB; 

makePersonalDirectoryRLIPB; 


addDSAMPB; 
instantiateDSAMPB; 
removeDSAMPB; 
addDSAMDirectoryPB; 
getExtendedDirectoriesInf oPB; 
get Di rectory I conPB; 


/* call to dsRefNum for system (PowerTalk Setup) personal catalog */ 
DirGetOCESetupRefNumPB dirGetOCESetupRefNumPB; 
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/* abort a aysnchronous call */ 

DirAbortPB abortPB; 

}; 

typedef union DirParamBlock DirParamBlock; 

typedef DirParamBlock *DirParamBlockPtr ; 

Catalog Manager Functions 

Getting Information About Catalogs 

pascal OSErr DirEnumerateDirectoriesGet 

(DirParamBlockPtr paramBlock, 

Boolean async) ; 

pascal OSErr DirEnumerateDirectoriesParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirFindRecordGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirFindRecordParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetDirectorylnf o 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetLocalNetworkSpec 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetDirectorylcon 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetExtendedDirectoriesInfo 

(DirParamBlockPtr paramBlock, Boolean async); 

Getting Information About DNodes 

pascal OSErr DirEnumerateGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirEnumerateParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetDNodeMetalnf o 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirMapDNodeNumberToPathName 

(DirParamBlockPtrparamBlock, Boolean async) ; 

pascal OSErr DirMapPathNameToDNodeNumber 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetDNodelnf o 

(DirParamBlockPtr paramBlock, Boolean async); 
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Maintaining the PowerTalk Setup Catalog 

pascal OSErr DirAddADAPDirectory 

(DirParamBlockPtr paramBlock, Boolean async) ; 
pascal OSErr DirFindADAPDirectoryByNetSearch 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr irNetSearchADAPDirectoriesGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirNetSearchADAPDirectoriesParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirRemoveDirectory 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetOCESetupRefnum 

(DirParamBlockPtr paramBlock, Boolean async); 

Creating, Opening, and Closing Personal Catalogs 

pascal OSErr DirCreatePersonalDirectory 

(DirParamBlockPtr paramBlock) ; 

pascal OSErr DirOpenPersonalDirectory 

(DirParamBlockPtr paramBlock) ; 

pascal OSErr DirClosePersonalDirectory 

(DirParamBlockPtr paramBlock) ; 

pascal OSErr DirMakePersonalDirectoryRLI 

(DirParamBlockPtr paramBlock) ; 

Managing Records 

pascal OSErr DirAddRecord (DirParamBlockPtr paramBlock, Boolean async); 
pascal OSErr DirDeleteRecord 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetRecordMetalnf o 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetNameAndType 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirSetNameAndType 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirAddPseudonym 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirDeletePseudonym 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirEnumeratePseudonymGet 

(DirParamBlockPtr paramBlock, Boolean async); 
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pascal OSErr DirEnumeratePseudonyraParse 

(DirParamBlockPtr paramBlock, Boolean async) ; 

pascal OSErr DirAddAlias (DirParamBlockPtr paramBlock, Boolean async) ; 

Managing Attribute Types and Values 

pascal OSErr DirAddAttributeValue 

(DirParamBlockPtr paramBlock, Boolean async) ; 

pascal OSErr DirDeleteAttributeValue 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirChangeAttributeValue 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirVerifyAttributeValue 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirFindValue (DirParamBlockPtr paramBlock, Boolean async) ; 

pascal OSErr DirLookupGet (DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirLookupParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirDeleteAttributeType 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirEnumerateAttributeTypesGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirEnumerateAttributeTypesParse 

(DirParamBlockPtr paramBlock, Boolean async); 

Reading Access Controls for dNodes, Records, and Attribute Types 

pascal DSSpec *OCEGetAccessControlDSSpec 

(const CategoryMask categoryBitMask) ; 

pascal OSErr DirGetDNodeAccessControlGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetDNodeAccessControlParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetRecordAccessControlGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetRecordAccessControlParse 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetAttributeAccessControlGet 

(DirParamBlockPtr paramBlock, Boolean async); 

pascal OSErr DirGetAttributeAccessControlParse 

(DirParamBlockPtr paramBlock, Boolean async); 
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Canceling a Catalog Manager Function 

pascal OSErr DirAbort (DirParamBlockPtr paramBlock) ; 

Application-Defined Functions 

void MyCompletionRoutine (DirParamBlockPtr paramBlk) ; 

pascal Boolean MyForEachRecordID 

(long clientData, const RecordID *recordID) ; 

pascal Boolean MyForEachAttrType 

(long clientData, 
const AttributeType *attrType) ; 

pascal Boolean MyForEachDirectory 

(long clientData, 
const DirectoryName *dirName, 
const DirDiscriminator ^discriminator , 
DirGestalt features) ; 

pascal Boolean MyForEachLookupRecordID 

(long clientData, const RecordID *recordID) ; 

pascal Boolean MyForEachAttrTypeLookup 

(long clientData, 
const AttributeType *attrType, 

AccessMask myAttrAccMask) ; 

pascal Boolean MyForEachAttrValue 

(long clientData, const Attribute ^attribute) ; 

pascal Boolean MyForEachDirEnumSpec 

(long clientData, const DirEnumSpec *enumSpec) ; 

pascal Boolean MyForEachRecord 

(long clientData, 
const DirEnumSpec *enumSpec, 
pRLI PackedRLIPtr ) ; 

pascal Boolean MyForEachADAPDirectory 

(long clientData, 

const DirectoryName *directoryName, 
const DirDiscriminator ^discriminator , 
DirGestalt features, AddrBlock serverHint); 

pascal Boolean MyForEachDNodeAccessControl 

(long clientData, const DSSpec *dsObj, 
AccessMask activeDnodeAccMask, 

AccessMask def aultRecordAccMask, 

AccessMask def aultAttributeAccMask) ; 
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pascal Boolean MyForEachRecordAccessControl 

(long clientData, const DSSpec *dsObj, 
AccessMask activeDnodeAccMask, 
AccessMask activeRecordAccMask, 
AccessMask def aultAttributeAccMask) ; 
pascal Boolean MyForEachAttributeAccessControl 

(long clientData, const DSSpec *dsObj, 
AccessMask activeDnodeAccMask, 
AccessMask activeRecordAccMask, 
AccessMask activeAttributeAccMask) ; 


Pascal Summary 

Constants and Data Types 

CONST 

{access categories bit numbers} 


kThisRecordOwnerBit = 0; 
kFriendsBit = 1; 
kAuthenticatedlnDNodeBit = 2; 
kAuthenticatedlnDirectoryBit = 3; 
kGuestBit = 4 ; 
kMeBit = 5; 


{values of CategoryMask } 
kThisRecordOwnerMask 
kFriendsMask 

kAuthenticatedlnDNodeMask 
kAuthenticatedlnDirectoryMask 

kGuestMask 
kMeMask 

kEnumDistinguishedNameBit = 0; 

kEnumAliasBit = 1; 

kEnumPseudonymBit = 2; 

kEnumDNodeBit = 3; 

kEnumlnvisibleBit = 4; 

{values of DirEnumChoices } 

kEnumDistinguishedNameMask = $00000001; { K<kEnumDistinguishedNameBit } 

kEnumAliasMask = $00000002; { KkkEnumAliasBit } 


= $00000001; { K<kThisRecordOwnerBit } 

= $00000002; { l<<kFriendsBit } 

= $00000004; { K<kAuthenticatedInDNodeBit } 

= $00000008; 

{ K<kAuthenticatedInDirectoryBit } 
= $00000010; { l<<kGuestBit } 

= $00000020; {l«kMeBit} 
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kEnumPseudonymMask = $00000004; { l<<kEnumPseudonymBit } 

kEnumDNodeMask = $00000008; { l<<kEnumDNodeBit } 

kEnumlnvisibleMask = $00000010; { l<<kEnumInvisibleBit } 

kEnumAHMask = (kEnumDistinguishedNameMask + kEnumAliasMask + 

kEnumPseudonymMask + kEnumDNodeMask + kEnumlnvisibleMask) ; 


{Values of DirSortOption } 

kSortByName = 0; 

kSortByType = 1; 

{values of DirSortDirection } 

kSortForwards = 0; 

kSortBackwards = 1; 

{values of DirMatchWith } 

kMatchAll = 0; 

kExactMatch = 1; 

kBeginsWith = 2; 

kEndingWith = 3; 

kContaining = 4; 

kCurrentOCESortVersion = 1; 

kSupportsDNodeNumberBit = 0; 

kSupportsRecordCreationIDBit = 1; 

kSupportsAttributeCreationIDBit = 2; 

kSupportsMatchAUBit = 3; 

kSupportsBeginsWithBit = 4; 

kSupportsExactMatchBit = 5; 

kSupportsEndsWithBit = 6; 

kSupportsContainsBit = 7; 

kSupportsOrderedEnumerationBit = 8; 

kCanSupportNameOrderBit = 9; 

kCanSupportTypeOrderBit = 10; 

kSupportSortBackwardsBit = 11; 

kSupportlndexRatioBit = 12; 

kSupportsEnumerationContinueBit = 13; 

kSupportsLookupContinueBit = 14; 

kSupportsEnumerateAttributeTypeContinueBit = 15; 

kSupportsEnumeratePseudonymContinueBit = 16; 

kSupportsAliasesBit = 17; 

kSupportsPseudonymsBit = 18; 

kSupportsPartialPathNamesBit = 19; 
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kSupportsAuthenticationBit 
kSupportsProxiesBit 
k Support sFindRecordBit 

{ values of DirGestalt } 
k Support sDNodeNumberMask 


= 20 ; 
= 21 ; 
= 22 ; 


= $ 00000001 ; 

{ K<kSupportsDNodeNumberBit } 

kSupportsRecordCreationIDMask = $00000002; 

{ K<kSupportsRecordCreationIDBit } 
kSupportsAttributeCreationIDMask = $00000004; 

{ K<kSupportsAttributeCreationIDBit } 

= $00000008; 

{ K<kSupportsMatchAllBit } 

= $ 00000010 ; 

{ K<kSupportsBeginsWithBit } 

= $ 00000020 ; 

{ K<kSupportsExactMatchBit } 

= $00000040; 

{ K<kSupportsEndsWithBit } 

= $00000080; 

{ l<<kSupportsContainsBit } 

kSupportsOrderedEnumerationMask = $00000100; 

{ K<kSupportsOrderedEnumerationBit } 

= $ 00000200 ; 

{ K<kCanSupportNameOrderBit } 

= $00000400; 

{ K<kCanSupportTypeOrderBit } 

= $00000800; 

{ K<kSupportSortBackwardsBit } 

= $ 00001000 ; 

{ K<kSupportIndexRatioBit } 

kSupportsEnumerationContinueMask = $00002000; 

{ K<kSupportsEnumerationContinueBit } 
kSupportsLookupContinueMask = $00004000; 

{ K<kSupportsLookupContinueBit } 
kSupportsEnumerateAttributeTypeContinueMask = $00008000; 

{ K<kSupportsEnumerateAttributeTypeContinueBit } 
kSupportsEnumeratePseudonymContinueMask = $00010000; 

{ K<kSupportsEnumeratePseudonymContinueBit } 
kSupportsAliasesMask = $00020000; 

{ l<<kSupportsAliasesBit } 

kSupportsPseudonymsMask = $00040000; 

{ l<<kSupportsPseudonymsBit } 

kSupportsPartialPathNamesMask = $00080000; 


kSupportsMatchAHMask 

kSupportsBeginsWithMask 

kSupportsExactMatchMask 

kSupportsEndsWithMask 

kSupportsContainsMask 


kCanSupportNameOrderMask 
kCanSupportTypeOrderMask 
kSupportSortBackwardsMask 
kSupport IndexRatioMask 


00 
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{ K<kSupportsPartialPathNamesBit } 
kSupportsAuthenticationMask = $00100000; 

{ l<<kSupportsAuthenticationBit } 
kSupportsProxiesMask = $00200000; 

{ l<<kSupportsProxiesBit } 

kSupportsFindRecordMask = $00400000; 

{ K<kSupportsFindRecordBit } 


TYPE 


DirEnumChoices 

= 

LONGINT; 

DirMatchWith 

= 

BYTE; 

DirSortDirection 

= 

INTEGER; 

ForMyEachRecordID 

= 

ProcPtr; 

ForMyEachLookupRecordID 

= 

ProcPtr; 

ForMyEachAttrTypeLookup 

= 

ProcPtr; 

ForMyEachAttrValue 

= 

ProcPtr; 

ForMyEachAttrType 

= 

ProcPtr; 

ForMyEachRecordID 

= 

ProcPtr; 

ForMyEachDNodeAccessControl 

= 

ProcPtr; 

ForMyEachRecordAccessControl 

= 

ProcPtr; 

ForMyEachAttributeAccessControl 

= 

ProcPtr; 

ForMyEachDirEnumSpec 

= 

ProcPtr; 

ForMyEachDi rectory 

= 

ProcPtr; 

ForMyEachADAPDi rectory 

= 

ProcPtr; 


DNodelD = RECORD 

dNodeNumber : 
reservedl : 
name : 

reserved2 : 

END; 

DirEnumSpec = RECORD 

enumFlag: DirEnumChoices; 

indexRatio: INTEGER; {if supported, approx Record Position 

between 1 and 100; 0 If not supported} 

CASE INTEGER OF 

1: ( recordldentif ier : LocalRecordID) ; 

2: (dNodeldentif ier : DNodelD); 

END; 

DirMetalnfo = RECORD 

info: ARRAY [1.. 4] OF LONGINT; 

END; 


DNodeNum; {dNode number} 

LONGINT; 

RStringPtr ; 

LONGINT; 
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SLRV = RECORD 

script: ScriptCode; {script code in which entries are sorted} 

language: INTEGER; {language code in which entries are sorted} 

regionCode: INTEGER; {region code in which entries are sorted} 

version: INTEGER; {version of AOCE sorting software } 

END; 

AuthDirParamHeader = RECORD 


qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 


END; 

{Catalog types and operations} 

Authldentity = LONGINT; {unique identifier for an identity} 

Localldentity = Authldentity; {umbrella localldentity } 

DirEnumerateDirectoriesGetPB = PACKED RECORD 


qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGING- 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 


Summary of the Catalog Manager 


8-353 


Catalog Manager 


CHAPTER 8 

Catalog Manager 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


direct oryKind : 

OCEDirectoryKind; 

{enumerate catalogs 

startingDirectoryName : 

DirectoryNamePtr ; 

bearing this signature} 
{starting catalog name} 

startingDirDiscriminator : 

DirDiscriminator ; 

{starting catalog 

eReserved : 

LONGINT; 

discriminator } 

f Reserved : 

LONGINT; 


gReserved : 

LONGINT; 


hReserved : 

LONGINT; 


includeStartingPoint : 

BOOLEAN; 

{if true, return catalog 

padByte : 

Byte; 

specified by starting 
point } 

HReserved: 

INTEGER; 


getBuf fer : 

Ptr; 


getBuf ferSize : 

LONGINT; 


END; 

DirEnumerateDirectoriesParsePB = RECORD 


qLink : 

Ptr; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr ; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity ; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aReserved : 

LONGINT; 


bReserved : 

LONGINT; 


eReserved : 

LONGINT; 


dReserved : 

LONGINT; 


eachDi rectory : 

ForEachDi rectory ; 


f Reserved : 

LONGINT; 
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gReserved : 
hReserved : 
iReserved : 
getBuf f er : 
getBuf ferSize : 

END; 

DirFindRecordGetPB = 

qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
startingPoint : 
reservedA: 
nameMatchString : 
typesList : 
typeCount : 
reservedB : 
reservedC : 
matchNameHow : 
matchTypeHow : 
getBuf fer : 
getBuf ferSize : 
directoryName : 
discriminator : 

END; 

DirFindRecordParsePB 
qLink : 
reservedl : 
reserved2 : 


LONGINT; 

LONGINT; 

LONGINT; 

Ptr; 

LONGINT; 

RECORD 

Ptr; 

LONGINT; 

LONGINT; 

ProcPtr ; 

OSErr ; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity ; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

RecordIDPtr; 

ARRAY [1.. 2] OF LONGINT; 
RStringPtr; 

''RStringPtr ; 

LONGINT; 

LONGINT; 

INTEGER; 

DirMatchWith; 

DirMatchWith; 

Ptr; 

LONGINT; 

DirectoryNamePtr ; 
DirDiscriminator ; 

= RECORD 

Ptr ; 

LONGINT; 

LONGINT; 
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ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
startingPoint : 
reservedA: 
nameMatchString : 
typesList : 
typeCount : 
reservedB : 
reservedC : 
matchNameHow : 
matchTypeHow : 
getBuf fer : 
getBuf ferSize : 
directoryName : 
discriminator : 
f orEachRecordFunc : 

END; 


ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

RecordIDPtr; 

ARRAY [1.. 2] OF LONGINT 
RStringPtr ; 
A RStringPtr; 

LONGINT; 

LONGINT; 

INTEGER; 

DirMatchWith; 

DirMatchWith; 

Ptr; 

LONGINT; 

DirectoryNamePtr ; 
DirDiscriminator ; 
ForEachRecord; 


DirGetDirectorylnf oPB = RECORD 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 


Ptr; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 
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gReserved3 : 
clientData : 
directoryName : 
discriminator : 

features : 

END; 

DirGetLocalNetworkSpecPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD ; 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
directoryName : 
discriminator : 
networkSpec : 


LONGINT; 

LONGINT; 

Direct oryNamePtr ; 
DirDiscriminator; 

DirGestalt ; 

RECORD 

Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 


AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

Direct oryNamePtr 
DirDiscriminator 
NetworkSpecPtr ; 


{catalog name} 
discriminate between 
duplicate catalog 
names } 

{capability bit flags} 


{catalog name} 

{ discriminator } 
{NetworkSpec } 


LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 


00 


END; 


DirGetDi rectory I conPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 


RECORD 

Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 
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identity : 

Authldentity; 



gReservedl : 

LONGINT; 



gReserved2 : 

LONGINT; 



gReserved3 : 

LONGINT; 



clientData : 

LONGINT; 



pRLI : 

PackedRLIPtr ; 

{packed RLI for 

the catalog} 

iconType : 

OSType; 

{type of Icon requested} 

iconBuf f er : 

Ptr; 

{buffer to hold 

Icon Data} 

buf ferSize : 

LONGINT; 

{size of buffer 

to hold icon 



data } 


END; 





D i rGet Ext endedD i rectories I nfoPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
buffer : 

buf ferSize : 

totalEntries : 
actualEntries : 

END; 

ForEachDirectory = ProcPtr; 

{FUNCTION ForEachDirectory (clientData : long; dirName: DirectoryNamePtr ; 
discriminator: DirDiscriminator ; features: DirGestalt): BOOLEAN;} 


= RECORD 
Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGING- 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 

AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

Ptr; {Pointer to a buufer 

where data is returned} 
LONGINT; {Length of buffer in which 

actual data is returned} 
LONGINT; {total number of catalogs found} 

LONGINT; {total number of catalog 

entries returned} 
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DirEnumerateGetPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRLI : 


PACKED RECORD 
Ptr; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr ; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 

AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

PackedRLIPtr; {an RLI specifying the cluster 

to be enumerated} 


startingPoint : 
sortBy : 

sortDirection : 
dReserved : 
nameMatchString : 

typesList : 

typeCount : 
enumFlags : 
includeStartingPo 

padByte : 
matchNameHow : 

matchTypeHow : 
getBuf fer : 
getBuf ferSize : 
responseSLRV : 


A DirEnumSpec ; 
DirSortOption; 
DirSortDirection; 
LONGINT; 
RStringPtr ; 

A RStringPtr ; 

LONGINT; 
DirEnumChoices ; 

: BOOLEAN; 

Byte; 

DirMatchWith; 

DirMatchWith; 

Ptr; 

LONGINT; 

SLRV ; 


{name from which enumeration 
should start} 

{list of entity types to be 
enumerated} 

{number of types in the list} 
{indicates what to enumerate} 

{if true return the record 
specified in starting point} 

{matching Criteria} 

{for nameMatchString} 

{matching criteria for typeList} 


{response SLRV} 


END; 


00 


DirEnumerateParsePB = RECORD 
qLink: Ptr; 

reservedl: LONGINT; 

reserved2 : LONGINT; 
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ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRLI : 


ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

PackedRLIPtr; 


bReserved : 
cReserved : 
eachEnumSpec : 
eReserved : 
fReserved : 
gReserved : 
hReserved : 
iReserved : 
getBuf fer : 
getBuf ferSize : 
HReserved: 
HReserved : 
HReserved : 
HReserved : 


LONGINT; 

LONGINT; 

ForEachDirEnumSpec; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

Ptr; 

LONGINT; 

INTEGER; 

INTEGER; 

INTEGER; 

INTEGER; 


{an RLI specifying the 
to be enumerated} 


END; 


DirGetDNodeMetalnf oPB = RECORD 


qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 


Ptr; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 


cluster 
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gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


pRLI : 

PackedRLIPtr; 


met a Inf o : 

DirMetalnfo; 


END; 



DirMapDNodeNumberToPathNamePB = RECORD 


qLink : 

Ptr; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 


serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity ; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


directoryName : 

DirectoryNamePtr ; 

{catalog name} 

discriminator : 

DirDiscriminator; 

{ discriminator } 

dNodeNumber : 

DNodeNum; 

{dNodenumber to be mapped} 

path : 

PackedPathNamePtr ; 

{packed path name returned} 

lengthOfPathName : INTEGER; 

{length of packed pathname 



structure } 

END; 



DirMapPathNameToDNodeNumberPB = RECORD 


qLink : 

Ptr ; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGING- 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 


serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 
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calllD : 

LONGINT; 



identity : 

Authldentity; 



gReservedl : 

LONGINT; 



gReserved2 : 

LONGINT; 



gReserved3 : 

LONGINT; 



clientData : 

LONGINT; 



directoryName : 

DirectoryNamePtr ; 


{catalog name} 

discriminator : 

DirDiscriminator ; 


{ discriminator } 

dNodeNumber : 

DNodeNum; 


{dNode number to the path} 

path : 

>; 

PackedPathNamePtr ; 


{pathname to be mapped} 

rGetDNodelnf oPB 

= RECORD 



qLink : 

Ptr; 



reservedl : 

LONGINT; 



reserved2 : 

LONGINT; 



ioCompletion : 

ProcPtr; 



ioResult : 

OSErr; 



saveA5 : 

LONGINT; 



reqCode : 

INTEGER; 



reserved : 

ARRAY [1.. 2] OF LONGINT; 


serverHint : 

AddrBlock; 



dsRefNum: 

INTEGER; 



calllD : 

LONGINT; 



identity : 

Authldentity; 



gReservedl : 

LONGINT; 



gReserved2 : 

LONGINT; 



gReserved3 : 

LONGINT; 



clientData : 

LONGINT; 



pRLI : 

PackedRLIPtr; 

{packed 

RLI whose info is requested} 

descriptor : 

DirNodeKind; 

{dNode descriptor} 

networkSpec : 

NetworkSpecPtr ; 

{ cluster 

's networkSpec if klsCluster} 


END; 


D i r AddAD AP DirectoryPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 


PACKED RECORD 
Ptr; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 


8-362 


Summary of the Catalog Manager 



CHAPTER 8 


Catalog Manager 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


directoryName : 

Direct oryNamePtr ; 

{catalog name} 

discriminator : 

DirDiscriminator ; 

{discriminate between} 

duplicate catalog names} 

addToOCESetup : 

BOOLEAN; 

{add this catalog to 

PowerTalk setup} 

padByte : 

Byte; 


directoryRecordCID : 

END; 

CreationID; 

{creation ID for the 

catalog record} 

DirFindADAPDirectoryByNetSearchPB = PACKED 

RECORD 

qLink : 

Ptr ; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr ; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


directoryName : 

Direct oryNamePtr; 

{catalog name} 

discriminator : 

DirDiscriminator; 

{discriminate between 

duplicate names} 

addToOCESetup : 

BOOLEAN; 

{add this catalog to PowerTalk 
Setup list} 

padByte : 

Byte; 


directoryRecordCID : 

CreationID; 

{creation ID for the catalog 

record} 


00 
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DirNetSearchADAPDirectoriesGetPB = RECORD 
qLink : Ptr; 


reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGING- 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

getBuf fer : 

Ptr ; 

getBuf ferSize : 

LONGINT; 

cReserved : 

END; 

LONGINT; 

DirNetSearchADAPDirectoriesParsePB = RECORD 

qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGIN 

serverHint : 

AddrBlock ; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

getBuf fer : 

Ptr; 

getBuf ferSize : 

LONGINT; 

eachADAPDirectory : ForEachADAPDirectory ; 

END; 
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ForEachADAPDirectory = ProcPtr; 

{FUNCTION ForEachADAPDirectory ( 
clientData: long; 
dirName: DirectoryNamePtr ; 
discriminator : DirDiscriminator ; 
features: DirGestalt; 
serverHint: AddrBlock) : BOOLEAN;} 


DirRemoveDirectoryPB = 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
directoryRecordCID : 

END; 


RECORD 
Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGING- 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

CreationID; {creation ID 


for the catalog record} 


DirRemoveDirectoryPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 


RECORD 
Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 
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clientData: LONGINT; 

directoryRecordCID : CreationID; {creation ID for the catalog record} 

END; 

DirGetOCESetupRefNumPB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
oceSetupRecordCID : 

END; 

DirCreatePersonalDirectoryPB = RECORD 
qLink : Ptr; 

reservedl: LONGINT; 

reserved2 : LONGINT; 

ioCompletion: ProcPtr; 

ioResult: OSErr; 

saveA5 : LONGINT; 

reqCode: INTEGER; 

reserved: ARRAY [1.. 2] OF LONGINT; 

serverHint: AddrBlock; 

dsRefNum: INTEGER; 

calllD : LONGINT; 

identity: Authldentity; 

gReservedl: LONGINT; 

gReserved2 : LONGINT; 

gReserved3 : LONGINT; 

clientData: LONGINT; 

fsSpec: FSSpecPtr; {FSSpec for the personal catalog} 


= RECORD 
Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGING- 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

CreationID; {creation ID 


for the catalog record} 
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fdType: OSType; {file type for the personal catalog} 

fdCreator: OSType; {file creator for the personal catalog} 

END; 


DirOpenPersonalDirectoryPB = PACKED 


qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [ 1 . . 2 ] OF 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

f sSpec : 

FSSpecPtr ; 

accessRequested : 

Char ; 

accessGr anted : 

Char; 

features : 

DirGestalt ; 


END; 


RECORD 


LONGINT; 


{open an existing personal catalog} 
{open: permissions requested (byte)} 
{open: permissions (byte) (Granted) 
{features for personal catalog} 


DirClosePersonalDirectoryPB = RECORD 


qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 
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gReserved3 : LONGINT; 

clientData: LONGINT; 

END; 


DirMakePersonalDirectoryRLIPB = RECORD 


qLink : 

Ptr; 



reservedl : 

LONGINT; 



reserved2 : 

LONGINT; 



ioCompletion : 

ProcPtr; 



ioResult : 

OSErr; 



saveA5 : 

LONGINT; 



reqCode : 

INTEGER; 



reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 


serverHint : 

AddrBlock; 



dsRefNum: 

INTEGER; 



calllD : 

LONGINT; 



identity : 

Authldentity; 



gReservedl : 

LONGINT; 



gReserved2 : 

LONGINT; 



gReserved3 : 

LONGINT; 



clientData : 

LONGINT; 



f romFSSpec : 

FSSpecPtr ; 

{FSSpec for creat 

ing relative alias} 

pRLIBuf ferSize 

: INTEGER; 

{length of 'pRLI' 

buffer } 

pRLISize : 

INTEGER; 

{length of actual 

'pRLI ' } 

pRLI : 

PackedRLIPtr ; 

{pRLI for the specified address book} 

END; 




DirAddRecordPB = 

RECORD 



qLink : 

Ptr; 



reservedl : 

LONGINT; 



reserved2 : 

LONGINT; 



ioCompletion : 

ProcPtr; 



ioResult : 

OSErr; 



saveA5 : 

LONGINT; 



reqCode : 

INTEGER; 



reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 


serverHint : 

AddrBlock; 



dsRefNum: 

INTEGER; 



calllD : 

LONGINT; 



identity : 

Authldentity; 



gReservedl : 

LONGINT; 



gReserved2 : 

LONGINT; 



gReserved3 : 

LONGINT; 



clientData : 

LONGINT; 
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aRecord: RecordIDPtr; {creation ID returned here} 

allowDuplicate : BOOLEAN; 

END; 

DirDeleteRecordPB = RECORD 


qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

END; 

DirGetRecordMetalnf oPB = RECORD 

qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

metainfo : 

DirMetalnfo; 


END; 
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RECORD 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

Longint ; 

RecordIDPtr; 


DirGetNameAndTypePB = 
qLink : Ptr; 

reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRecord : 

END; 

DirSetNameAndTypePB 
qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRecord : 
allowDuplicate : 
padByte : 
newName : 
newType : 

END; 


= PACKED RECORD 
Ptr; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

RecordIDPtr; 

BOOLEAN; 

Byte; 

RStringPtr; 

RStringPtr; 


{ new 

name 

for 

the 

record} 

{ new 

type 

for 

the 

record} 
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DirAddPseudonymPB 

= RECORD 


qLink : 

Ptr ; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGING- 


reqCode : 

INTEGER; 


reserved : 

ARRAY [ 1 . . 2 ] 

OF LONGINT; 

serverHint : 

AddrBlock ; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity 

r 

gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aRecord : 

RecordIDPtr ; 

{record ID 

pseudonymName : 

RStringPtr; 

{new name 

pseudonymType : 

RStringPtr; 

{new name 

allowDuplicate : 

: BOOLEAN; 


END; 



DirDeletePseudonymPB = RECORD 


qLink : 

Ptr; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aRecord : 

RecordIDPtr; 

{ record 


to be 


to be 
to be 
to be 


ID to 
added} 


added to pseudonym} 
added as pseudonym} 
added as pseudonym} 


which pseudonym is 


00 
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pseudonymName : RStringPtr; 
pseudonymType : RStringPtr; 
END; 


{pseudonymName 

{pseudonymType 


to be deleted} 
to be deleted} 


DirEnumeratePseudonymGetPB = PACKED RECORD 


qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGING- 

reqCode : 

INTEGER; 

reserved : 

ARRAY [ 1 . . 2 ] i 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr ; 

startingName : 

RStringPtr; 

startingType : 

RStringPtr; 

dReserved : 

LONGINT; 

eReserved : 

LONGINT; 

f Reserved : 

LONGINT; 

gReserved : 

LONGINT; 

hReserved : 

LONGINT; 

includeStartingPoint : 

BOOLEAN; {if 

by 

padByte : 

Byte; 

ilReserved: 

INTEGER; 

getBuf fer : 

Ptr ; 

getBuf ferSize : 

LONGINT; 


END; 


DirEnumeratePseudonymParsePB = RECORD 
qLink : Ptr; 

reservedl : LONGINT; 

reserved2 : LONGINT; 

ioCompletion : ProcPtr; 

ioResult: OSErr; 

saveA5 : LONGINT; 
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reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRecord : 
bReserved : 
cReserved : 
eachRecordID : 
eReserved : 
f Reserved : 
gReserved : 
hReserved : 
iReserved : 
getBuf f er : 
getBuf ferSize : 

END; 


INTEGER; 

ARRAY [1.. 2] OF LONGINT; 

AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

RecordIDPtr; {same as DirEnumerateAliasesGetPB } 

LONGINT; 

LONGINT; 

ForEachRecordID; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

Ptr; 

LONGINT; 


DirAddAliasPB = RECORD 


qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr ; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock ; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

allowDuplicate : 

r 

BOOLEAN; 


DirAddAttributeValuePB = RECORD 
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qLink : 

Ptr; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

Longint ; 


aRecord : 

RecordIDPtr; 


attr : 

AttributePtr; 


END; 

DirDeleteAttributeValuePB = RECORD 

qLink : 

Ptr; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aRecord : 

RecordIDPtr; 


attr : 

AttributePtr; 



END; 

DirChangeAttributeValuePB = RECORD 
qLink : Ptr; 

reservedl : LONGINT; 


8-374 


Summary of the Catalog Manager 



CHAPTER 8 


Catalog Manager 


reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

currentAttr : 

AttributePtr; 

newAttr : 

AttributePtr; 


END; 

DirVerifyAttributeValuePB = RECORD 


qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr; 

ioResult : 

OSErr; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

attr : 

AttributePtr; 

END; 


DirFindValuePB = 

RECORD 

qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 
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ioCompletion : ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity ; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aRLI : 

PackedRLIPtr; 

{an RLI specifying the cluster 

to be enumerated} 

aRecord : 

LocalRecordIDPtr; 

{if not nil, look only in this 

record} 

attrType : 

AttributeTypePtr ; 

{if not nil, look only in this 
attribute type} 

startingRecord : 

LocalRecordIDPtr; 

{record in which to start 

searching} 

startingAttribute : 

AttributePtr; 

{attribute in which to start 

searching} 

recordFound : 

LocalRecordIDPtr; 

{record in which data was found 

attributeFound : 

Attribute; 

{attribute in which data was 

found} 

matchSize : 

LONGINT; 

{length of matching bytes} 

matchingData : 

Ptr; 

{data bytes to be matched in 

search } 

s o rt Di recti on : 

END; 

DirSortDirection; 

{sort direction (forwards or 

backwards) } 

DirLookupGetPB = RECORD 

qLink : 

Ptr ; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr; 


ioResult : 

OSErr; 


saveA5 : 

LONGING- 


reqCode : 

INTEGER; 


reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 
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calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aRecordList : 

A RecordIDPtr ; 

{an array of record ID 



pointers } 

attrTypeList : 

A AttributeTypePtr ; 

{an array of attribute type; 

cReserved : 

LONGINT; 


dReserved : 

LONGINT; 


eReserved : 

LONGINT; 


f Reserved : 

LONGINT; 


recordIDCount : 

LONGINT; 


attrTypeCount : 

LONGING- 


includeStartingPoint : 

BOOLEAN; 

{if true, return the value 



specified by the starting 

indices } 

{padByte : 

Byte; } 


ilReserved: 

INTEGER; 


getBuf f er : 

Ptr; 


getBuf ferSize : 

LONGINT; 


startingRecordlndex : 

LONGINT; 

{start from this record} 

startingAttrTypelndex : LONGINT; 

{start from this attribute 



type} 

startingAttribute : 

Attribute; 

{start from this attribute 



value } 

pReserved : 

LONGINT; 


END; 



DirLookupParsePB = RECORD 


qLink : 

Ptr; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr ; 


ioResult : 

OSErr ; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 
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gReserved2 : 
gReserved3 : 
clientData : 
aRecordList : 

attrTypeList : 

cReserved : 
eachRecordID : 
eachAttrType : 
eachAttrValue : 
recordIDCount : 

attrTypeCount : 

iReserved : 
getBuf fer : 

getBuf ferSize : 

lastRecordlndex : 

last At tribute Index : 

lastAttribute : 

attrSize : 

END; 


LONGINT; 

LONGINT; 

LONGINT; 

A RecordIDPtr ; {must be same from the 

corresponding Get call} 

A AttributeTypePtr ; {must be same from the 

corresponding Get call} 

LONGINT; 

ForEachLookupRecordID; 

ForEachAttrTypeLookup; 

ForEachAttrValue; 

LONGINT; {must be same from the 

corresponding Get call} 

LONGINT; {must be same from the 

corresponding Get call} 

LONGINT; 

Ptr; {must be same from the 

corresponding Get call} 

LONGINT; {must be same from the 

corresponding Get call} 

LONGINT; {last RecordID processed when 

parse completed} 

LONGINT; {last Attribute Type processed 

when parse completed} 

Attribute; {last attribute value (with 

this creation ID) processed 
when parse completed} 

LONGINT; {length of the attribute that 

was not returned} 


DirDeleteAttributeTypePB = RECORD 


qLink : 

Ptr; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr ; 

ioResult : 

OSErr ; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock ; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity ; 
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gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

attrType : 

AttributeTypePtr ; 

END; 


DirEnumerateAttributeTypesGetPB = PACKED RECORD 

qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr ; 

ioResult : 

OSErr; 

saveA5 : 

LONGING- 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock ; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity ; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

aRecord : 

RecordIDPtr; 

startingAttrType : 

AttributeTypePtr; {starting point} 

cReserved : 

LONGINT; 

dReserved : 

LONGINT; 

eReserved : 

LONGINT; 

fReserved : 

LONGINT; 

gReserved : 

LONGINT; 

hReserved : 

LONGINT; 

includeStartingPoint 

: BOOLEAN; {if true, return the attribute 


Type specified by starting point} 

padByte : 

Byte; 

ilReserved: 

INTEGER; 

getBuf fer : 

Ptr ; 

getBuf ferSize : 

LONGINT; 

END; 


DirEnumerateAttributeTypesParsePB = RECORD 

qLink : 

Ptr ; 

reservedl : 

LONGINT; 
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DirGetDNodeAccessControlGetPB = RECORD 


qLink : 

Ptr ; 

reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr ; 

ioResult : 

OSErr; 

saveA5 : 

LONGING- 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock ; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity ; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 
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clientData : 
pRLI : 

bReserved : 
cReserved : 
dReserved : 
eResreved : 
f orCur rent Use rOnly : 
startingPoint : 
includeStartingPoint : 

getBuf fer : 
getBuf ferSize : 

END; 


LONGINT; 

PackedRLIPtr; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

BOOLEAN; 

A DSSpec; 

BOOLEAN; 

Ptr; 

LONGINT; 


{RLI of the cluster whose 
access control list is sought} 


{starting point} 

{if true, return the DsObject 
specified in starting point} 


DirGetDNodeAccessControlParsePB = RECORD 


qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
pRLI : 

bReserved : 
cReserved : 
dReserved : 
eachOb ject : 
f orCur rent Use rOnly : 
startingPoint : 
includeStartingPoint : 


Ptr ; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr ; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 
AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity ; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

PackedRLIPtr; 

LONGINT; 

LONGINT; 

LONGINT; 

ForEachDNodeAccessControl ; 
BOOLEAN; 

A DSSpec ; 

BOOLEAN; 


{RLI of the cluster} 
{unused} 

{unused} 

{unused} 

{starting point} 

{if true, return 
the record 
specified in 
in starting point} 
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getBuffer: Ptr; 

getBuf ferSize : LONGINT; 

END; 


DirGetRecordAccessControlGetPB = RECORD 


qLink : 

Ptr ; 



reservedl : 

LONGINT; 



reserved2 : 

LONGINT; 



ioCompletion : 

ProcPtr; 



ioResult : 

OSErr; 



saveA5 : 

LONGING- 



reqCode : 

INTEGER; 



reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 


serverHint : 

AddrBlock; 



dsRefNum: 

INTEGER; 



calllD : 

LONGINT; 



identity : 

Authldentity; 



gReservedl : 

LONGINT; 



gReserved2 : 

LONGINT; 



gReserved3 : 

LONGINT; 



clientData : 

LONGINT; 



aRecord : 

RecordIDPtr ; 

{ RecordID 

whose access 



control 

list is sought } 

bReserved : 

LONGINT; 

{unused} 


cReserved : 

LONGINT; 

{unused} 


dReserved : 

LONGINT; 

{unused} 


eResreved : 

LONGINT; 



f orCur rent Use rOnly : 

BOOLEAN; 



startingPoint : 

A DSSpec; 

{ starting 

Point } 

includeStartingPoint : 

BOOLEAN; 

{if true. 

return the DsObject 



specified in starting point} 

getBuffer : 

Ptr; 



getBuf ferSize : 

LONGINT; 



END; 




DirGetRecordAccessControlParsePB = RECORD 



qLink : 

Ptr ; 



reservedl : 

LONGINT; 



reserved2 : 

LONGINT; 



ioCompletion : 

ProcPtr; 



ioResult : 

OSErr; 



saveA5 : 

LONGINT; 



reqCode : 

INTEGER; 



reserved : 

ARRAY [ 1 . . 2 ] OF 

LONGINT; 
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serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRecord : 

bReserved : 
cReserved : 
dReserved : 
eachOb ject : 
f orCur rent Use rOnly : 
startingPoint : 
includeStartingPoint : 

getBuf f er : 
getBuf ferSize : 

END; 


AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

RecordIDPtr; {RecordID whose access 

control list is sought} 
LONGINT; {unused} 

LONGINT; {unused} 

LONGINT; {unused} 

ForEachRecordAccessControl ; 

BOOLEAN; 

A DSSpec; {starting point} 

BOOLEAN; {if true, return the 

record specified in} 
{starting point} 

Ptr; 

LONGINT; 


DirGetAttributeAccessControlGetPB = RECORD 


qLink : 
reservedl : 
reserved2 : 
ioCompletion : 
ioResult : 
saveA5 : 
reqCode : 
reserved : 
serverHint : 
dsRefNum: 
calllD : 
identity : 
gReservedl : 
gReserved2 : 
gReserved3 : 
clientData : 
aRecord : 

aType : 


Ptr; 

LONGINT; 

LONGINT; 

ProcPtr; 

OSErr ; 

LONGINT; 

INTEGER; 

ARRAY [1.. 2] OF LONGINT; 

AddrBlock; 

INTEGER; 

LONGINT; 

Authldentity; 

LONGINT; 

LONGINT; 

LONGINT; 

LONGINT; 

RecordIDPtr; {RecordID whose access 

control list is sought} 
AttributeTypePtr ; {attribute type to which 

access controls are sought} 
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cReserved : 

LONGINT; 


dReserved : 

LONGINT; 

{unused} 

eResreved : 

LONGING- 


f orCur rent Use rOnly : 

BOOLEAN; 


includeStartingPoint : 

BOOLEAN; 

{if true, return the DsObject 

getBuf f er : 

Ptr; 

specified in starting point} 

getBuf ferSize : 

LONGINT; 


END; 

DirGetAttributeAccessControlParsePB = RECORD 


qLink : 

Ptr ; 


reservedl : 

LONGINT; 


reserved2 : 

LONGINT; 


ioCompletion : 

ProcPtr ; 


ioResult : 

OSErr; 


saveA5 : 

LONGINT; 


reqCode : 

INTEGER; 


reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock ; 


dsRefNum: 

INTEGER; 


calllD : 

LONGINT; 


identity : 

Authldentity; 


gReservedl : 

LONGINT; 


gReserved2 : 

LONGINT; 


gReserved3 : 

LONGINT; 


clientData : 

LONGINT; 


aRecord : 

RecordIDPtr ; 

{record ID whose access 

aType : 

AttributeTypePtr ; 

control list is sought} 
{attribute type whose 

cReserved : 

LONGINT; 

access controls are sought} 

dReserved : 

LONGINT; 


eachOb ject : 

ForEachAttributeAccessControl ; 

f orCur rent Use rOnly : 

BOOLEAN; 


startingPoint : 

A DSSpec; 

{starting Point } 

includeStartingPoint : 

BOOLEAN; 

{if true, return the record 

getBuf fer : 

Ptr; 

specified in starting point} 

getBuf ferSize : 

LONGINT; 



END; 
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DirAbortPB = RECORD 


qLink : Ptr; 


reservedl : 

LONGINT; 

reserved2 : 

LONGINT; 

ioCompletion : 

ProcPtr ; 

ioResult : 

OSErr ; 

saveA5 : 

LONGINT; 

reqCode : 

INTEGER; 

reserved : 

ARRAY [1.. 2] OF LONGINT; 

serverHint : 

AddrBlock; 

dsRefNum: 

INTEGER; 

calllD : 

LONGINT; 

identity : 

Authldentity; 

gReservedl : 

LONGINT; 

gReserved2 : 

LONGINT; 

gReserved3 : 

LONGINT; 

clientData : 

LONGINT; 

pb : 

Ptr; {parameter 

aborted { A 


END; 


DirParamBlock = RECORD 
CASE INTEGER OF 
1: (header: 

2: (addRecordPB : 

3: (deleteRecordPB : 

4: (enumerateGetPB : 

5: (enumerateParsePB : 

6: ( f indRecordGetPB : 

7: ( f indRecordParsePB : 

8: ( lookupGetPB : 

9: ( lookupParsePB : 

10: (addAttributeValuePB : 

11: (deleteAttributeTypePB : 

12: (deleteAttributeValuePB : 

13: (changeAttributeValuePB : 

14: (verifyAttributeValuePB : 

15: ( f indValuePB : 

16: (enumeratePseudonymGetPB : 
17: (enumeratePseudonymParsePB: 
18: (addPseudonymPB : 

19: (deletePseudonymPB : 

20: (addAliasPB: 


AuthDirParamHeader ) ; 
DirAddRecordPB) ; 
DirDeleteRecordPB) ; 
DirEnumerateGetPB) ; 
DirEnumerateParsePB) ; 
DirFindRecordGetPB) ; 
DirFindRecordParsePB) ; 
DirLookupGetPB) ; 
DirLookupParsePB) ; 
DirAddAttributeValuePB) ; 
DirDeleteAttributeTypePB) ; 
DirDeleteAttributeValuePB) ; 
DirChangeAttributeValuePB) ; 
DirVerifyAttributeValuePB) ; 
DirFindValuePB) ; 
DirEnumeratePseudonymGetPB) ; 
DirEnumeratePseudonymParsePB) ; 
DirAddPseudonymPB) ; 
DirDeletePseudonymPB) ; 
DirAddAliasPB) ; 


21 : (enumerateAttributeTypesGetPB : DirEnumerateAttributeTypesGetPB) ; 


00 
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22 : (enumerateAttributeTypesParsePB : 

DirEnumerateAttributeTypesParsePB) ; 
23: (getNameAndTypePB : DirGetNameAndTypePB) ; 

24: ( setNameAndTypePB : DirSetNameAndTypePB) ; 

25: (getRecordMetalnf oPB : DirGetRecordMetalnf oPB) ; 

26: (getDNodeMetalnfoPB : DirGetDNodeMetalnf oPB) ; 

27: (getDirectorylnfoPB : DirGetDirectorylnf oPB) ; 

28: (getDNodeAccessControlGetPB : DirGetDNodeAccessControlGetPB) ; 

2 9 : (getDNodeAccessControlParsePB : DirGetDNodeAccessControlParsePB) ; 

30: (getRecordAccessControlGetPB : DirGetRecordAccessControlGetPB) ; 

31 : (getRecordAccessControlParsePB : 

DirGetRecordAccessControlParsePB) ; 

32 : (getAttributeAccessControlGetPB : 

DirGetAttributeAccessControlGetPB) ; 

33 : (getAttributeAccessControlParsePB : 

DirGetAttributeAccessControlParsePB) ; 
34: (enumerateDirectoriesGetPB : DirEnumerateDirectoriesGetPB) ; 

35: (enumerateDirectoriesParsePB : DirEnumerateDirectoriesParsePB) ; 

36: (addADAPDirectoryPB : DirAddADAPDirectoryPB) ; 

37: ( removeDirectoryPB : DirRemoveDirectoryPB) ; 

38 : (netSearchADAPDirectoriesGetPB : 

DirNetSearchADAPDirectoriesGetPB) ; 

39 : (net Sear chADAPDirectoriesParsePB : 

DirNetSearchADAPDirectoriesParsePB) ; 
40 : ( f indADAPDirectoryByNetSearchPB : 

DirFindADAPDirectoryByNetSearchPB) ; 
41: (mapDNodeNumberToPathNamePB : DirMapDNodeNumberToPathNamePB) ; 

42: (mapPathNameToDNodeNumberPB : DirMapPathNameToDNodeNumberPB) ; 

43: (getLocalNetworkSpecPB : DirGetLocalNetworkSpecPB) ; 

44: (getDNodelnf oPB : DirGetDNodelnf oPB) ; 

{calls for personal catalogs} 

45: (createPersonalDirectoryPB : DirCreatePersonalDirectoryPB) ; 

46: (openPersonalDirectoryPB : DirOpenPersonalDirectoryPB) ; 

47: (closePersonalDirectoryPB : DirClosePersonalDirectoryPB) ; 

48: (makePersonalDirectoryRLIPB : DirMakePersonalDirectoryRLIPB) ; 

{calls For CSAMs} 


49: 

(addDSAMPB : 

DirAddDSAMPB) ; 

50: 

( instantiateDSAMPB : 

DirlnstantiateDSAMPB) ; 

51 : 

( removeDSAMPB : 

DirRemoveDSAMPB) ; 

52 : 

(addDSAMDirectoryPB : 

DirAddDSAMDirectoryPB) ; 
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53 : ( get Ext endedDi rectories I nfoPB : 

Di rGetExtendedDi rectories Inf oPB) ; 
54: (getDirectorylconPB : DirGetDirectorylconPB) ; 

{call to dsRefNum for system ( Setup : PowerTalk) personal catalog} 

55: (dirGetOCESetupRefNumPB : DirGetOCESetupRefNumPB) ; 

{abort a aysnchronous call} 

56: (abortPB: DirAbortPB) ; 

END; 

DirParamBlockPtr = A DirParamBlock; 

Catalog Manager Functions 


00 


Getting Information About Catalogs 

FUNCTION DirEnumerateDirectoriesGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION D i rEnume r at eDirectorie sParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirFindRecordGet (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirFindRecordParse (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirGetDirectorylnf o 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetLocalNetworkSpec 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetDirectorylcon 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION Di rGetExtendedDi rectories Inf o 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 
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Getting Information About DNodes 

FUNCTION DirEnumerateGet (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirEnumerateParse (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirGetDNodeMetalnf o 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirMapDNodeNumberToPathName 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirMapPathNameToDNodeNumber 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetDNodelnf o (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

Maintaining the PowerTalk Setup Catalog 

FUNCTION DirAddADAPDirectory 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirFindADAPDirectoryByNet Search 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirNetSearchADAPDirectoriesGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION D i rNet Sear chADAPDirect or ie sParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirRemoveDirectory 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetOCESetupRefNum 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

Creating, Opening, and Closing Personal Catalogs 

FUNCTION D i rC r eat ePersonalDi rectory 

(paramBlock: DirParamBlockPtr) : OSErr; 

FUNCTION DirOpenPersonalDi rectory 

(paramBlock: DirParamBlockPtr) : OSErr; 
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FUNCTION DirClosePersonalDi rectory 

(paramBlock: DirParamBlockPtr ) : OSErr; 

FUNCTION DirMakePersonalDirectoryRLI 

(paramBlock: DirParamBlockPtr) : OSErr; 

Managing Records 

FUNCTION DirAddRecord (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirDeleteRecord (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirGetRecordMetalnf o 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetNameAndType (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirSetNameAndType (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirAddPseudonym (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirDeletePseudonym 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirEnumeratePseudonymGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirEnumeratePseudonyraParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirAddAlias (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

Managing Attribute Types and Values 

FUNCTION DirAddAttributeValue 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirDeleteAttributeValue 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirChangeAttributeValue 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 
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FUNCTION DirVerifyAttributeValue 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirFindValue (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirLookupGet (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirLookupParse (paramBlock: DirParamBlockPtr; 

async: BOOLEAN) : OSErr; 

FUNCTION DirDeleteAttributeType 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirEnumerateAttributeTypesGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION D i rEnume r at eAt tribute Type sParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

Reading Access Controls for dNodes, Records, and Attribute Types 

FUNCTION OCEGetAccessContro IDS Spec 

( categoryBitMask : CategoryMask) : DSSpecPtr; 

FUNCTION DirGetDNodeAccessControlGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetDNodeAccessControlParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetRecordAccessControlGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetRecordAccessControlParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetAttributeAccessControlGet 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 

FUNCTION DirGetAttributeAccessControlParse 

(paramBlock: DirParamBlockPtr; 
async: BOOLEAN) : OSErr; 
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Canceling a Catalog Manager Function 

FUNCTION DirAbort (paramBlock: DirParamBlockPtr ) : OSErr; 

Application-Defined Functions 

FUNCTION MyCompletionRoutine 

(paramBlk: DirParamBlockPtr); 

FUNCTION MyForEachRecordID (clientData: long; 

recordID: RecordID) : BOOLEAN; 

FUNCTION MyForEachAttrType (clientData: long; 

attrType: AttributeType) : BOOLEAN; 

FUNCTION MyForEachDirectory 

(clientData: long; dirName: DirectoryNamePtr; 
discriminator : DirDiscriminator; 
features: DirGestalt) : BOOLEAN; 

FUNCTION MyForEachLookupRecordID 

(clientData: long; 
recordID: RecordID) : BOOLEAN; 

FUNCTION MyForEachAttrTypeLookup 

(clientData: long; attrType: AttributeTypePtr; 
myAttrAccMask : AccessMask) : BOOLEAN; 

FUNCTION MyForEachAttrValue (clientData: long; 

attribute: Attribute) : BOOLEAN; 

FUNCTION MyForEachDirEnumSpec 

(clientData: LONGINT; 
enumSpec: DirEnumSpec) : BOOLEAN; 

FUNCTION MyForEachRecord ((clientData: long; 

dsOb j : DSSpec; activeDnodeAccMask : AccessMask; 
activeRecordAccMask : AccessMask; 

def aultAttributeAccMask : AccessMask) : BOOLEAN;} 

FUNCTION MyForEachADAPDirectory 

(clientData: long; dirName: DirectoryNamePtr; 
discriminator : DirDiscriminator; 
features: DirGestalt; serverHint : AddrBlock) : 
BOOLEAN; 

FUNCTION MyForEachDNodeAccessControl 

(clientData: long; dsOb j : DSSpec; 
activeDnodeAccMask: AccessMask; 
def aultRecordAccMask : AccessMask; 
def aultAttributeAccMask : AccessMask) : BOOLEAN; 
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FUNCTION MyForEachRecordAccessControl 

(clientData: long; dsOb j : DSSpec; 
activeDnodeAccMask : AccessMask; 
activeRecordAccMask : AccessMask; 
def aultAttributeAccMask : AccessMask) : BOOLEAN; 

FUNCTION MyForEachAttributeAccessControl 

(clientData: long; dsOb j : DSSpec; 
activeDnodeAccMask: AccessMask; 
activeRecordAccMask : AccessMask; 
activeAttributeAccMask : AccessMask) : BOOLEAN; 


Assembly-Language Summary 


Trap Macros Requiring Routine Selectors 

_oceTBDispatch 


Selector 

Routine 

0x101 

DirEnumerateParse 

0x102 

DirLookupParse 

0x103 

DirEnumerateAttributeTypesParse 

0x104 

DirEnumeratePseudonymParse 

0x105 

DirNetSearchADAPDirectoriesParse 

0x106 

DirEnumerateDirectoriesParse 

0x107 

DirFindADAPDirectoryByNetSearch 

$0108 

DirNetSearchADAPDirectoriesGet 

$0109 

DirAddRecord 

$010 A 

DirDe let eRe cord 

$01 0B 

DirAddAttributeValue 

$010C 

DirDe let eAttributeValue 

$01 0D 

DirChangeAttributeValue 

$01 0E 

DirVerif yAttributeValue 

$01 OF 

DirAddPseudonym 

$0110 

DirDeletePseudonym 

$0111 

DirEnumerateGet 

$0112 

DirEnumerateAttributeTypesGet 

$0113 

DirEnumeratePseudonymGet 

$0114 

DirGetNameAndType 

$0115 

DirSetNameAndType 

$0116 

DirGetRecordMetalnf o 
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Selector Routine 

$0117 DirLookupGet 

$0118 DirGetDNodeMetalnf o 

$0119 DirGetDirectorylnf o 

$011A DirEnumerateDirectoriesGet 

$011B DirAbort 

$011C DirAddAlias 

$011D DirAddDSAM 

$011E DirOpenPersonalDirectory 

$011F DirCreatePersonalDirectory 

$0121 DirGetDirectorylcon 

$0122 DirMapPathNameToDNodeNumber 

$0123 DirMapDNodeNumberToPathName 

$0124 DirGetLocalNetworkSpec 

$0125 DirGetDNodelnf o 

$0126 DirFindValue 

$0128 DirGetOCESetupRefNum 

$012A DirGetDNodeAccessControlGet 

$01 2C DirGetRecordAccessControlGet 

$01 2E DirGetAttributeAccessControlGet 

$01 2F DirGetDNodeAccessControlParse 

$0130 DirDeleteAttributeType 

$0131 DirClosePersonalDirectory 

$0132 DirMakePersonalDirectoryRLI 

$0134 DirGetRecordAccessControlParse 

$0135 DirRemoveDirectory 

$0136 DirGetExtendedDirectoriesInf o 

$0137 DirAddADAPDirectory 

$0138 DirGetAttributeAccessControlParse 

$0140 DirFindRecordGet 

$0141 DirFindRecordParse 
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Result Codes 

The allocated range of result codes for the Catalog Manager is -1610 through -1646 and 
there are some result codes in the range -1503 through -1567. Functions may also return 
result codes from other AOCE managers and standard Macintosh result codes such as 
noErr 0 (No error) and f nf Err -43 (File not found). 


kOCEBuf ferTooSmall 

kOCEVersionErr 

kOCEAlreadyExists 

kOCEReadAccessDenied 

kOCEWriteAccessDenied 

kOCEUnknownID 

kOCENot Local 

kOCETooBusy 

kOCEDatabaseFull 

kOCETarget Directory Inaccessible 

kOCEBogusArgs 

kOCENoSuchDNode 

kOCEDNodeUnavailable 

kOCEBadRecordID 

kOCENoSuchRecord 

kOCENoSuchAttributeValue 

kOCENoSuchPseudonym 

kOCEAttributeValueTooBig 

kOCETypeExists 

kOCEMoreData 

kOCERefNumBad 

kOCEStreamCreationErr 

kOCEOpe rat ionNot Supported 

kOCEPABNotOpen 

kOCEDSAMInstallErr 

kOCEDirListFullErr 

kOCEDirectoryNotFoundErr 

kOCEAbortNotSupportedForThisCall 


-1503 

Buffer too small for data requested 

-1504 

Need to sort personal catalog 

-1510 

The catalog being added already 
exists 

-1540 

Identity lacks read access 
privileges 

-1541 

Identity lacks write access 
privileges 

-1567 

Authentication identity is not 
valid 

-1610 

The server does not serve the 
requested dNode 

-1611 

Server cannot complete call at 
this time 

-1612 

The disk is full 

-1613 

Target catalog is not currently 
available 

-1614 

Args not formatted correctly on 
the wire 

-1615 

Can't find specified dNode 

-1616 

Could not find any servers that 
serve the requested dNode 

-1617 

Record name or record type 
doesn't match creation ID 

-1618 

Can't find specified record 

-1619 

Can't find specified attribute value 

-1620 

The specified pseudonym does 
not exist 

-1621 

Attribute value is larger than 

kAttrValueMaxBytes bytes 

-1622 

The type already exists in the 
record 

-1623 

More data available 

-1624 

RefNum is not valid 

-1625 

Error in creating connection to 
server 

-1626 

The specified catalog does not 
support this operation 

-1627 

The specified personal catalog is 
not open to make the operation 

-1628 

The specified CSAM could not be 
installed 

-1629 

The catalog list is full; try 
removing an entry 

-1630 

Can't find catalog 

-1631 

Abort not supported 
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kOCEAborted 

-1632 

The call was aborted 

kOCEOCESetupRequired 

-1633 

Localldentity Setup is required 

kOCEDSAMRecordNot Found 

-1634 

CSAM Record not found 

kOCEDSAMNot Instantiated 

-1635 

CSAM is not instantiated 

kOCEDSAMRecordExists 

-1636 

CSAM record already exists 

kOCELengthError 

-1637 

The buffer supplied was too small 

kOCEBadStartingRecord 

-1638 

Starting record index out of range 

kOCEBadSt art ingAt tribute 

-1639 

Starting attribute index is not 
within range 

kOCEMoreAttrValue 

-1640 

Buffer too small for a single 
attribute value 

kOCENoDupAl lowed 

-1641 

Duplicate name and type 

kOCENoSuchAttributeType 

-1642 

Can't find specified attribute type 

kOCEMiscError 

-1643 

Miscellaneous error 

kOCENoSuchlcon 

-1644 

There is no matching icon from 

OCEGetDirectorylcon 

kOCERLIsDontMatch 

-1645 

RLIs of different records in the 
record list are not the same 

kOCEDirectoryCorrupt 

-1646 

Serious disk fill corruption 
problem 
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